home *** CD-ROM | disk | FTP | other *** search
/ The Programmer Disk / The Programmer Disk (Microforum).iso / xpro / vc / pro10 / read.me < prev   
Text File  |  1993-07-21  |  10KB  |  259 lines

  1. Verona July 221, 1993
  2.  
  3.  
  4.  
  5.                        HIT_GRID Version 2.0 (Visual Basic 3.0)
  6.                        ---------------------------------------
  7.                           (for griglia.dll and d_grid.dll)
  8.  
  9.  
  10. A) Standard Properties
  11. ----------------------
  12. Please refer to Standard Grid Properties for documentation. (With the exception
  13. of the Picture and GridLineWidth properties).
  14.  
  15.  
  16. B) New Properties
  17. -----------------
  18.  
  19. 1) CursorRow
  20.    CursorCol
  21.  
  22.    Determine the cursor cell in a grid. Not available at design time. At every
  23.    cursor movement (by means of mouse or keyboard actions), both the cursor cell
  24.    properties and the active cell properties are set.
  25.  
  26. 2) EnableCol
  27.    EnableRow
  28.  
  29.    Determine whether a grid column, or a grid row can be disabled or enabled
  30.    at run time. Not available at run time.
  31.  
  32. 3) AccessCol
  33.    AccessRow
  34.  
  35.    Determine whether a grid column, or a grid row can be accessed by mouse or
  36.    keyboard movement. Not available at run time.
  37.  
  38. 4) EnableEdit
  39.  
  40.    Enum property. Valid values:
  41.         0 - Disable
  42.             edit box on top of grid control is visible and grid editing is disabled
  43.         1 - Enabled
  44.             edit box on top of grid control is visible and grid editing is enabled
  45.         3 - Erase
  46.             edit box on top of grid control is not visible however editing is enabled
  47.         4 - Erase / disable
  48.             edit box on top of grid control is not visible and grid editing is disabled
  49. 5) Author
  50.    Company
  51.    Address
  52.    Donation
  53.  
  54.    Provide infos about software writer.
  55.  
  56. 6) WrapRow
  57.    WrapCol
  58.  
  59.    Determine whether a grid column, or a grid row wrap text in multilines.
  60.  
  61.  
  62. C) Standard Events
  63. ------------------
  64. Please refer to Standard Grid Events for documentation.
  65.  
  66.  
  67. D) New Events
  68. -------------
  69.  
  70. 1) Change
  71.  
  72.     It occurs every time SelChange, or RowColChange events occur. It provides
  73.     info about the cell previous values or positions.
  74.  
  75.     Arguments:
  76.         Row         previous row value
  77.         Col         previous col value
  78.         Text        previous cell text content.
  79.  
  80.  
  81. E) C Language APIs
  82. ------------------
  83.  
  84. E.1) GRIGLIA.DLL (Visual Basic 3.0 and Visual C++ 1.0)
  85.  
  86.      Provides grid functionality and stores text strings internally.
  87.  
  88. 1) VOID FAR PASCAL _export RepaintGriglia (HWND hWnd)
  89.     Descr: Repaint whole grid
  90.     Args : hWnd     grid control handle
  91.  
  92. 2) VOID FAR PASCAL _export RepaintGrigliaBlock (HWND hWnd,
  93.                                                 UINT nLeftCol,
  94.                                                 UINT nTopRow,
  95.                                                 UINT nRightCol,
  96.                                                 UINT nBottomRow);
  97.     Descr: Repaint a grid block
  98.     Args:  hWnd       grid control handle
  99.            nLeftCol   block left column
  100.            nTopRow    block row
  101.            nRightCol  block right column
  102.            nBottomRow block bottom row
  103.  
  104. 3) BOOL FAR PASCAL _export GetGrigliaProperty (HWND   hWnd,
  105.                                                USHORT nProp,
  106.                                                LPVOID lpData);
  107.    BOOL FAR PASCAL _export SetGrigliaProperty (HWND,
  108.                                                USHORT nProp,
  109.                                                LPVOID lpData);
  110.  
  111.     Descr: Retrieves or sets grid properties
  112.     Args:  hWnd       grid control handle
  113.            nProp      property ID (see below)
  114.            lpData     to be retrieved or set (see CDK documentation);
  115.  
  116.            IPROP_GRIGLIA_ROWS              0x0017
  117.            IPROP_GRIGLIA_COLS              0x0018
  118.            IPROP_GRIGLIA_FIXEDROWS         0x0019
  119.            IPROP_GRIGLIA_FIXEDCOLS         0x001A
  120.            IPROP_GRIGLIA_ROW               0x001B
  121.            IPROP_GRIGLIA_COL               0x001C
  122.            IPROP_GRIGLIA_ROWHEIGHT         0x001D
  123.            IPROP_GRIGLIA_COLWIDTH          0x001E
  124.            IPROP_GRIGLIA_TOPROW            0x001F
  125.            IPROP_GRIGLIA_LEFTCOL           0x0020
  126.            IPROP_GRIGLIA_CURSORROW         0x0021
  127.            IPROP_GRIGLIA_CURSORCOL         0x0022
  128.            IPROP_GRIGLIA_TEXT              0x0023
  129.            IPROP_GRIGLIA_CLIP              0x0024
  130.            IPROP_GRIGLIA_SELSTARTROW       0x0025
  131.            IPROP_GRIGLIA_SELENDROW         0x0026
  132.            IPROP_GRIGLIA_SELSTARTCOL       0x0027
  133.            IPROP_GRIGLIA_SELENDCOL         0x0028
  134.            IPROP_GRIGLIA_ENABLECOL         0x0029
  135.            IPROP_GRIGLIA_ENABLEROW         0x002A
  136.            IPROP_GRIGLIA_ACCESSCOL         0x002B
  137.            IPROP_GRIGLIA_ACCESSROW         0x002C
  138.            IPROP_GRIGLIA_ENABLEEDIT        0x002D
  139.            IPROP_GRIGLIA_ENABLESCROLLBARS  0x002E
  140.  
  141.  
  142. 4) BOOL FAR PASCAL _export PutText (HWND  hWnd,
  143.                                     WORD  wRow,
  144.                                     WORD  wCol,
  145.                                     LPSTR lpText);
  146.  
  147.     Descr: Set cell text
  148.     Args:  hWnd       grid control handle
  149.            wRow       cell row
  150.            wCol       cell col
  151.            lpText     string to write
  152.  
  153. 5) LPSTR FAR PASCAL _export GetText (HWND  hWnd,
  154.                                      WORD  wRow,
  155.                                      WORD  wCol);
  156.  
  157.     Descr: Get cell text
  158.     Args:  hWnd       grid control handle
  159.            wRow       cell row
  160.            wCol       cell col
  161.  
  162.  
  163. E.2) D_GRID.DLL (Visual Basic 3.0 and Visual C++ 1.0)
  164.  
  165.      Provides grid functionality and uses callback functions to
  166.      set or get grid cell text.
  167.  
  168. 1) VOID FAR PASCAL _export dRepaintGriglia (HWND hWnd)
  169.     Descr: Repaint whole grid
  170.     Args : hWnd     grid control handle
  171.  
  172. 2) VOID FAR PASCAL _export dRepaintGrigliaBlock (HWND hWnd,
  173.                                                 UINT nLeftCol,
  174.                                                 UINT nTopRow,
  175.                                                 UINT nRightCol,
  176.                                                 UINT nBottomRow);
  177.     Descr: Repaint a grid block
  178.     Args:  hWnd       grid control handle
  179.            nLeftCol   block left column
  180.            nTopRow    block row
  181.            nRightCol  block right column
  182.            nBottomRow block bottom row
  183.  
  184. 3) BOOL FAR PASCAL _export dGetGrigliaProperty (HWND   hWnd,
  185.                                                 USHORT nProp,
  186.                                                 LPVOID lpData);
  187.    BOOL FAR PASCAL _export dSetGrigliaProperty (HWND,
  188.                                                 USHORT nProp,
  189.                                                 LPVOID lpData);
  190.  
  191.     Descr: Retrieves or sets grid properties
  192.     Args:  hWnd       grid control handle
  193.            nProp      property ID (see below)
  194.            lpData     to be retrieved or set (see CDK documentation);
  195.  
  196.            IPROP_GRIGLIA_ROWS              0x0017
  197.            IPROP_GRIGLIA_COLS              0x0018
  198.            IPROP_GRIGLIA_FIXEDROWS         0x0019
  199.            IPROP_GRIGLIA_FIXEDCOLS         0x001A
  200.            IPROP_GRIGLIA_ROW               0x001B
  201.            IPROP_GRIGLIA_COL               0x001C
  202.            IPROP_GRIGLIA_ROWHEIGHT         0x001D
  203.            IPROP_GRIGLIA_COLWIDTH          0x001E
  204.            IPROP_GRIGLIA_TOPROW            0x001F
  205.            IPROP_GRIGLIA_LEFTCOL           0x0020
  206.            IPROP_GRIGLIA_CURSORROW         0x0021
  207.            IPROP_GRIGLIA_CURSORCOL         0x0022
  208.            IPROP_GRIGLIA_TEXT              0x0023
  209.            IPROP_GRIGLIA_CLIP              0x0024
  210.            IPROP_GRIGLIA_SELSTARTROW       0x0025
  211.            IPROP_GRIGLIA_SELENDROW         0x0026
  212.            IPROP_GRIGLIA_SELSTARTCOL       0x0027
  213.            IPROP_GRIGLIA_SELENDCOL         0x0028
  214.            IPROP_GRIGLIA_ENABLECOL         0x0029
  215.            IPROP_GRIGLIA_ENABLEROW         0x002A
  216.            IPROP_GRIGLIA_ACCESSCOL         0x002B
  217.            IPROP_GRIGLIA_ACCESSROW         0x002C
  218.            IPROP_GRIGLIA_ENABLEEDIT        0x002D
  219.            IPROP_GRIGLIA_ENABLESCROLLBARS  0x002E
  220.  
  221.  
  222. 4) BOOL FAR PASCAL _export dPutText (HWND  hWnd,
  223.                                      WORD  wRow,
  224.                                      WORD  wCol,
  225.                                      LPSTR lpText);
  226.  
  227.     Descr: Set cell text
  228.     Args:  hWnd       grid control handle
  229.            wRow       cell row
  230.            wCol       cell col
  231.            lpText     string to write
  232.  
  233. 5) LPSTR FAR PASCAL _export dGetText (HWND  hWnd,
  234.                                       WORD  wRow,
  235.                                       WORD  wCol);
  236.  
  237.     Descr: Get cell text
  238.     Args:  hWnd       grid control handle
  239.            wRow       cell row
  240.            wCol       cell col
  241.  
  242. 6) BOOL FAR PASCAL _export SetCallBackEntry (HWND    hWnd,
  243.                                              WORD    nFunction,
  244.                                              FARPROC pFunc);
  245.  
  246.     Descr: Define callback functions
  247.     Args:  hWnd       grid control handle
  248.            nFunction  function ID (see below)
  249.                       #define ICALLBACK_GETCELLTEXT           0x0000
  250.                       #define ICALLBACK_PUTCELLTEXT           0x0001
  251.            pFunc      pointer to function to provide or retrieve text.
  252.                       The function args are:
  253.  
  254.                       a) ICALLBACK_GETCELLTEXT
  255.                          LPSTR (*lpGetCellText) (WORD wRow, WORD wCol)
  256.  
  257.                       a) ICALLBACK_PUTCELLTEXT
  258.                          BOOL  (*lpPutCellText) (WORD wRow, WORD wCol, LPSTR lpText)
  259.